BBS in a Box 11

home *** CD-ROM | disk | FTP | other *** search

/ BBS in a Box 11 / AMUG BBS in a Box Volume XI (April 1994) (MacWizards).iso / Files / Prog / T / ToolsPlus 2.1.sit / Tools Plus 2.1 ƒ / Tools Plus 2.1 (C & Pascal) / User Manual / 00-Contents < prev next >

Wrap

Text File | 1993-10-24 | 10.3 KB | 321 lines | [TEXT/ttxt]

Contents ```````` 1 Introduction to Tools Plus What is Tools Plus An Overview of Tools Plus Who can benefit from Tools Plus What kind of applications can be written with Tools Plus What is Tools Plus not suitable for System Requirements Tools Plus Source Code and Site Licensing Assumptions made when writing this manual Convensions used throughout this manual Software Updates Your Development Environment For your information (recommended reading) 2 Installing Tools Plus Tools Plus Contents Installing Tools Plus for THINK C Adding Tools Plus to a THINK C Project THINK C Compiler Options Tools Plus Segments in THINK C Installing Tools Plus for THINK Pascal Adding Tools Plus to a THINK Pascal Project After Compiling Tools Plus Segments in THINK Pascal 3 Designing Your Application The Macintosh’s Events Macintosh Event Queue Key Up Events Tools Plus Events The Main Event Loop Finder (System 6) vs MultiFinder (System 6) and System 7 Finder MultiFinder System 7 The Pascal Interface file (ToolsPlus.p) The C Header file (ToolsPlus.h) Range Checking What to read next 4 Initialization Initializing Tools Plus Initialization Failure Other Initialization The Cursor 5 Windows Overview Title Bar, Close box, and Zoom box Size Box Maximum Number of Open Windows Active Window Current Window Modal Windows Global and Local Co-ordinates Handling Windows Opening a window Closing a window Activating a window Making a window current without activating it Making the active window current Changing a window’s title Setting a window’s cursor dragging boundary Setting size limits Setting the “standard” and “user” co-ordinates for zooming Getting the “standard” and “user” co-ordinates for zooming Getting a window’s status information Getting the window number of the active window Getting the window number of the current window Getting your applications front most window number Getting a window’s pointer 6 Buttons Overview Button Types Button States Button Titles Default Button Handling Buttons Creating a new button Fonts Default Button Deleting a button Enabling/Disabling a button Selecting/Deselecting a button Determining if a button is enabled Determining if a button is selected Changing a button’s title Flashing a button (simulating selection) Setting a default button Removing the “default button” status from a window 7 Scroll Bars Overview Scroll Bar States Handling Scroll Bars Creating a new scroll bar Deleting a scroll bar Enabling/Disabling a scroll bar Getting a scroll bar’s minimum setting limit Setting a scroll bar’s minimum setting limit Getting a scroll bar’s maximum setting limit Setting a scroll bar’s maximum setting limit Getting a scroll bar’s current value Setting a scroll bar’s current value 8 Editing Fields Overview Field Length Capacity Alignment of text in a field The Active Field The Field’s String & Edited Text Fonts Length Limited Fields Word Wrap Clicking and Tabbing in fields Using Fields Editing Fields and Typed Characters… What Happens? Old Macintosh keyboard with numeric pad The Edit Menu Handling Fields Special Handling of Fields Creating a new field Fonts Deleting a field Activating a field Activating a field Clicking in an inactive field Getting the active field’s edited text Saving the active field’s edited text as the field’s string Getting the active field’s number Turning field length limiting on/off Repositioning a field Scrolling fields Pasting into a field under your application’s control 9 List Boxes Overview Fonts Handling List Boxes Creating a new list box Selection Methods Fonts Deleting a list box Adding a new line / replacing an existing line in a list box Getting a line’s text Searching lines for specific text (alphabetic order) Selecting/Deselecting a line Determine if a line is selected Determine the next selected line number Inserting a blank line into a list box Deleting a line Turning a list box’s drawing on/off 10 Menus Overview Menus and MultiFinder or System 7 Edit Menu Desk Accessories Editing Fields Menus and Editing Fields Menus and Desk Accessories Command Key Equivalents Handling Menus Creating the Apple menu Creating/renaming a menu or menu item Meta Characters Inserting a menu item Deleting a menu or menu item Updating the menu bar (redrawing it) Rename a menu item Enabling/disabling a menu or menu item Check mark (displaying/hiding) Special marks (displaying/hiding) Changing a menu item’s style Highlight or unhighlight a menu 11 Cursors Overview Automatic Cursor Changes The Watch Cursor Starting your application The Cursor Table Advanced Features Cursor Animation Handling Cursors Changing the cursor’s shape Resetting cursor shape according to window orientation Creating a new cursor table Deleting a cursor table Creating a new cursor zone/replacing a cursor zone Deleting a cursor zone Deleting a cursor zone Making a window use a cursor table (or stop using one) Determining which cursor zone contains a specified point Enabling/disabling button clicks during a watch cursor 12 System Polling Overview What Is Polling? Task Switching Macintosh Events Watch Cursor -- a busy system The Event Queue Tools Plus Event Record Event Record Fields Event Modifiers Event Modifiers Using C Event Modifiers Using Pascal PollSystem (System polling) Tools Plus Event Codes What Does PollSystem Do? Internally Processed Events Externally Processed Events Inside PollSystem Translating Toolbox events to Tools Plus events Responding to Events doNothing doChgWindow doRefresh doGoAway doButton doMenu doKeyDown doAutoKey doKeyUp doClickField doScrollBar doListBox doClick doClickControl doManual doMoveWindow doGrowWindow event doClickDesk doZoomWindow doSuspend doResume Discontinuing multiple clicks or drags Determining if your application is suspended “Field to Event” Cross reference 13 Color Drawing & Multiple Monitors Overview Using One Monitor Using Multiple Monitors Changing Screen Settings Determining if Color QuickDraw is used Determining the number of logical screens Beginning color-dependent drawing on a window Ending color-dependent drawing on a window Determining the number of colors on a screen Determining if the screen is set to draw in color Resetting the current window’s pen to default values Getting the current window’s pen settings Setting the current window’s pen settings 14 Miscellaneous Routines Overview Displaying a Dynamic Alert What are Dynamic Alerts? Icons Text Buttons Custom Button Combinations Function’s Value Advanced Techniques Changing button titles on Dynamic Alerts Drawing an icon Intelligent Icon Drawing Icon Family Icon Selection Drawing the Icon, Selecting, Disabling, and Masking Creating Your Own Icons Determining the System version Determining the System version Wait for a specified time Drawing “Zoom Lines” Drawing a standard Macintosh progress thermometer Determining the minimum value of two numbers Determining the maximum value of two numbers 15 Other Macintosh Features Overview Alerts Dialogs Custom Controls Lists 16 Memory Overview Measurements Routines that consume heap space (by category) Routines that consume heap space (alphabetic) Good memory habits 17 Font Heights Font heights table 18 Special Routines Use these routines with caution, or don’t use them! 19 Completing Your Application Overview Application’s Icons Icon Family File Types, Creators, and the Application Signature Signature (the Creator code) Bundle Version mstr Resources SIZE Resource Cloned SIZE resources 20 Technical Support What does Technical Support do? What doesn’t Technical Support do?